home *** CD-ROM | disk | FTP | other *** search
/ The Doomsday Disk / THE DOOMSDAY DISK.iso / goodies / dfuse100 / readme.txt < prev    next >
Text File  |  1995-06-01  |  7KB  |  160 lines
  1.                            +====================+
  2.                            | DFUSE INSTALLATION | (package v 1.00)
  3.                            +====================+
  4.  
  5.           +---------------------------------------------------------+
  6.           | Dark Forces is (c) LucasArt Entertainment Company 1994  |
  7.           | DFUSE       is (c) Yves BORCKMANS 1995                  |
  8.           +---------------------------------------------------------+
  9.  
  10.  
  11. WELCOME TO DFUSE !
  12.  
  13. DFUSE (Dark Forces UtilitieS and Editor) is a collection of tools to design
  14. Dark Forces levels.
  15.  
  16. The main program DFUSE is in fact a "shell" around the following utilities:
  17.  - GOB file extractors (file by file, or all the .GOB) + reGOB.
  18.  - BM, FME and WAX file viewers
  19.  - BM -> BMP and BMP -> BM converters
  20.  - a full featured multi-layer, multi-selection level and objects editor.
  21.  
  22.  
  23. For those who used v 0.9x, see history.doc for LOTS OF modifications and search
  24. for the [NEW] keyword in all the doc files for details.
  25.  
  26. Important: if you have made custom texture files, backup them before
  27.            installing 1.00, and relink them in TEXTURES.DFU later.
  28.            You should also make a copy of DFUSE.INI
  29.  
  30.  
  31. WHAT DO YOU NEED TO RUN DFUSE ?
  32. ===============================
  33.  
  34. First of all, a graphic card handling at least 640x480x256 and supported by a
  35. BGI. All VESA cards are ok, so this shouldn't be a big problem.
  36.  
  37. Second, a mouse!
  38.  
  39. As I use the "deltree" DOS command, I think you need MSDOS 6.0 or above.
  40.  
  41. The basic configuration for playing Dark Forces is great, with a little
  42. addition: the use a disk cache (such as Microsoft's SMARTDRV) will greatly
  43. improve the performances of the editor. You should be able to use a small cache
  44. and still launch DF succesfully. Also try to maximize the free conventional
  45. memory as these programs aren't DOS extended, and some levels are HUGE.
  46. As DFUSE will stay in memory when you launch DF, it is overlaid on disk.
  47. The level editor (LEVMAP.EXE) is overlaid to use XMS as buffer (around 250K).
  48.  
  49. In addition to this, you may need a lot of disk space to extract the GOB files.
  50. DFUSE will only extract the levels you work on however so you can control the
  51. disk space used. You don't need to extract textures, frames or sprites to use
  52. the viewers integrated in the editor.
  53.  
  54. What you also need is a text editor that accept filenames on the command line
  55. and if possible a pager (or a text editor accepting BIG files).
  56. You may also use 'PAGE=PAGER.BAT %s' if you don't find a pager.
  57.  
  58. Note: EDIT needs too much memory (460+K) to be used in the level editor, so
  59. try to find something else or take the habit of editing .INF and .GOL in DFUSE
  60. (ie out of the level editor). It is much more annoying for the object seqs !
  61.  
  62. A VOC file player and a VOC -> WAV converters are also supported, but these are
  63. far from mandatory.
  64.  
  65.  
  66. COMPATIBILITY & KNOWN PROBLEMS
  67. ==============================
  68.  
  69. The programs run correctly under OS/2 and Windows, but Windows seems sometimes
  70. unable to restore the screen properly when switching back to the programs.
  71. In that case, type 'Z' to get a DOS shell, then 'exit'.
  72.  
  73. During the tests I made, I also tried them on 4DOS. They run perfectly well
  74. if you follow the following rules:
  75.  - do not ALIAS "dir" ,"type", "del", "deltree", "more" or "sort".
  76.    If you do this make a .bat/alias to unalias them, launch dfuse, and realias.
  77.  - file overwrite/redirection must be set to minimum protection
  78.    (see your 4DOS manuals) or 4DOS will systematically ask for a confirmation,
  79.    and some of the messages won't be visible in graphic mode. If you seem to
  80.    be stuck try pressing 'y'.
  81.  
  82. LEVMAP needs a 486 and a MATH COPROCESSOR to run. If you have a 386 or a 486sx
  83. processor, also download the DFUMP3SX.EXE file.
  84.  
  85. INSTALLATION 
  86. ============
  87.  
  88. There is no install program at this time, so you'll have to follow these steps
  89. very carefully (it won't take more than 2 minutes if all is ok):
  90.  
  91.  - type 'DFUSE100 -d'  DO NOT FORGET the -d option !!
  92.  - edit the file DFUSE.INI
  93.     * set the correct path to your installed game directory (normally c:\dark)
  94.       under the [INSTALLED] header.
  95.     * setup your tools under the [TOOLS] header.
  96.     * setup graphics under the [BGI] header (try VESA and 257 or 259 first).
  97.  - save the file
  98.  
  99.  - if you have a 386 or 486sx processor
  100.     * type 'ren levmap.exe levmap.487'
  101.     * type 'DFUMP3SX'
  102.     * type 'ren levmap.3sx levmap.exe'
  103.  
  104.  - type 'DFUSE'
  105.     if   the graphics are ok continue
  106.     else edit DFUSE.INI and try other MODES or BGI
  107.  - go to Levels Menu   (L)
  108.  - select Choose level (C)
  109.  - choose 'SECBASE'
  110.  - select MAP          (M)
  111.  
  112.  - if all is correct, you should see a little (c) message, then progress bars,
  113.    then the map of the first level!
  114.    Else, there is a problem :
  115.     * are you sure you extracted with -d option ?
  116.     * are you sure of the [INSTALLED] path ?
  117.  
  118.  - press the 'i' key to edit the .INF file.
  119.     if   your editor opens up memory is ok, close the file and continue
  120.     else try pressing 'z' to get a DOS shell
  121.       if it opens ok, it is your editor that is too big
  122.          you may try to find another text editor using less memory
  123.       else
  124.          you will need to gain some conventionnal memory (see your DOS manuals)
  125.       (HINT: when in the level editor, see free memory with Alt + C)
  126. [- if you got a DOS shell, type 'exit' ]
  127.  
  128.  - press the escape key until you are back at the DOS prompt
  129.  
  130. Installation is complete!
  131.  
  132.  - read the dfuse.doc, levmap.doc (and levkeys.doc) and the df_specs.doc files
  133.    in the DOC directory
  134.  - play with the editor, try the demos (and read their docs)
  135.  - learn it, love it, hate it...
  136.  - ... but make beautiful levels and put them on the net !
  137.  - don't forget to try a 800x600+ mode for the map editor in DFUSE.INI
  138.  
  139.  
  140. VERSION NOTES
  141. =============
  142.  
  143. The package version has nothing to do with the individual executable versions,
  144. which are for my own version management.
  145.  
  146. The files DFUSExxx.txt and readme.1st are exactly the same. One or both exist
  147. because different sites have different file names and packaging conventions.
  148.  
  149. Important: the 1.00 version is now considered the reference code base for
  150.            future minor releases (1.xx), which will be posted as upgrades and
  151.            will contain only the modified files.
  152.  
  153.            Q.: What does that mean ?
  154.            A.: You won't have to download megabytes again until 2.00 :)
  155.  
  156.  
  157. Yves BORCKMANS (yborckmans@abcomp.be (work))
  158.  
  159. Please state the package version when you email me.
  160.